Skip to main content

SmartAgent Version 9.12.3

Release Date: March 25, 2026

Version Overview​

SmartAgent 9.12.3 focuses on process collection whitelist and parent-child process metric split strategy, along with DotnetAgent 6.15.4 and GoAgent 5.0.1 upgrades, JavaAgent 9.12.2 stability fixes, and image, dockerhelper, and installation parameter optimizations.

  • ✨ Process Monitor Enhancement: Supports process collection whitelist; whitelist processes are collected unconditionally with independent parent-child metrics; non-whitelist child process metrics are merged to parent

  • ✨ DotnetAgent 6.15.4: Adapted for nms-ActiveMQ/AMQP interfaces; fixed GAC loading failure; fixed GCC4.8-regex defect that may cause crash

  • ✨ GoAgent 5.0.1: Fixed crash when using non-MySQL databases

  • ✨ JavaAgent 9.12.2: Optimized async thread error flag consistency; improved JDK 17 adaptation; fixed agent not re-registering when uid changes

  • 🔧 General Enhancements: Image 1.1.4; dockerhelper dead loop detection and mount path validation; install parameter optimization

Upgrade Recommendation
  • All users are recommended to upgrade for process collection flexibility and agent stability improvements;
  • Users of DotnetAgent, GoAgent, or JavaAgent should prioritize upgrading to fix known crash and registration issues.

Linux x86_64 System​

Supported Platform Versions​

  • One Platform: V2.2.2 and above

Integrated Agent Versions​

  • JavaAgent: 9.12.2
  • DotnetAgent: 6.15.4
  • PHPAgent: 8.5.0
  • PythonAgent: 8.6.0
  • NodejsAgent: 7.1.1
  • NginxAgent: 3.8.4
  • ApacheAgent: 3.4.0
  • SDKAgent: 5.14.1
  • GoAgent: 5.0.1
  • logsAgent: 2.3.0

New Features​

  1. Process Collection Whitelist and Parent-Child Process Metric Split Strategy:

    • a. Whitelist processes: unconditional metric collection
    • b. Whitelist processes: parent and child process metrics collected independently
    • c. Non-whitelist processes: child process metrics merged into parent process

    Add the following configuration to machine.yml:

# Process metric collection configuration
processMonitor:

  # Trigger threshold configuration (only applies to non-identified application processes)
  #
  # Agent uses 1-minute statistical intervals with a fixed sliding window:
  #   - Last 5 one-minute intervals
  #   - At least 3 intervals must meet the condition
  #
  # In any 1-minute interval, if any of the following conditions is met,
  # the interval is considered triggered:
  #   - Average CPU usage exceeds cpuThreshold
  #   - Maximum memory usage exceeds memoryThreshold
  #
  # When the number of triggered intervals meets the internal criteria,
  # the process will be collected and reported.
  triggerThresholds:
    cpuThreshold: 5        # Avg(CPU), unit: percentage, default: 5
    memoryThreshold: 5     # Max(Memory), unit: percentage, default: 5

  # Process forced collection whitelist (matched by executable name or process name)
  #
  # Behavior:
  # 1. Processes matching whiteList:
  #    - Collected unconditionally (not limited by CPU/memory thresholds)
  #    - Child process metrics are NOT aggregated
  #
  # 2. Processes not matching whiteList:
  #    - Collected only when trigger threshold strategy is met
  #    - Child process CPU/memory metrics are aggregated to parent process
  #
  # Matching rules:
  # - Use process executable name or process name
  # - Exclude path
  whiteList:
  #  - auditd

Feature Optimizations and Fixes​

1. JavaAgent Upgraded to 9.12.2​

Feature Optimizations

  • Optimized error request and call chain error flag consistency in async thread scenarios;
  • Optimized JDK 17 adaptation, avoiding Class.getGenericSignature0() exception.

Bug Fixes

  • Fixed agent not re-registering when uid changes occasionally (affects: JavaAgent 8.0.0～9.12.1, SmartAgent 6.0.0～9.12.1).

2. DotnetAgent Upgraded to 6.15.4​

Feature Optimizations

  • Adapted for nms-ActiveMQ/AMQP interfaces:
    • Apache.NMS.ActiveMQ-2.2.0: .NET Core 2.0/2.1/2.2/3.0/3.1, .NET 5.0/6.0/7.0/8.0
    • Apache.NMS.AMQP-2.4.0: .NET Core 2.0/2.1/2.2/3.0/3.1, .NET 5.0/6.0/7.0/8.0
  • Fixed GAC loading failure when introducing third-party WebApi library during installation.

Bug Fixes

  • Fixed GCC4.8-regex defect introduced by netcore version setting that may cause crash (affects: DotnetAgent 6.15.2, 6.15.3; SmartAgent 9.11.0～9.12.2).

3. GoAgent Upgraded to 5.0.1​

Bug Fixes

  • Fixed crash when using non-MySQL databases (affects: GoAgent 5.0.0; SmartAgent 9.11.0～9.12.2).

4. SmartAgent Image Updated to 1.1.4​

  • When configuring YAML array fields with --set-conf and --reset-conf, each element is placed on a separate line.

5. Install Parameter Optimization​

  • When configuring YAML array fields with --set-conf and --reset-conf, each element is placed on a separate line.

6. dockerhelper Dead Loop Detection Optimization​

  • Increased default check threshold to reduce false positives.

7. dockerhelper Optimization​

  • Validates mount target path; skips if invalid;
  • Added re-entry injection check.

Linux ARM64 System​

Supported Platform Versions​

  • One Platform: V2.2.2 and above

Integrated Agent Versions​

  • JavaAgent: 9.12.2
  • DotnetAgent: 6.15.4
  • PHPAgent: 8.5.0
  • PythonAgent: 8.6.0
  • NginxAgent: 3.8.4
  • SDKAgent: 5.14.1
  • GoAgent: 5.0.1
  • logsAgent: 2.3.0

Feature Optimizations and Fixes​

Platform Notes

The feature updates for this platform are basically consistent with Linux x86_64 system, with the main difference being agent support scope. Specifically includes:

New Features

  • Process collection whitelist and parent-child process metric split strategy (same as Linux x86_64)

Feature Optimizations and Fixes

  • Same as Linux x86_64 (including JavaAgent, DotnetAgent, GoAgent, image, install parameters, dockerhelper updates)

Notes

  • ARM64 platform does not currently support NodejsAgent, ApacheAgent

Windows x86_64 Platform​

Supported Platform Versions​

  • One Platform: V2.2.2 and above

Integrated Agent Versions​

  • JavaAgent: 9.12.2
  • DotnetAgent: 6.15.4

New Features​

  1. Process Collection Whitelist and Parent-Child Process Metric Split Strategy (same as Linux; see configuration above).

Feature Optimizations and Fixes​

1. JavaAgent Upgraded to 9.12.2​

(Same content as Linux platform)

2. DotnetAgent Upgraded to 6.15.4​

Feature Optimizations

  • Adapted for nms-ActiveMQ/AMQP interfaces:
    • Apache.NMS.ActiveMQ-1.7.1/2.2.0: .Net Framework 4.0+, .NET Core 2.0/2.1/2.2/3.0/3.1, .NET 5.0/6.0/7.0/8.0
    • Apache.NMS.AMQP-2.4.0: .Net Framework 4.6.1+, .NET Core 2.0/2.1/2.2/3.0/3.1, .NET 5.0/6.0/7.0/8.0
  • Fixed GAC loading failure when introducing third-party WebApi library during installation.

Bug Fixes

  • Fixed GCC4.8-regex defect introduced by netcore version setting that may cause crash (affects: DotnetAgent 6.15.2, 6.15.3; SmartAgent 9.11.0～9.12.2).

Compatibility Notes​

Platform Compatibility​

Operating SystemSupported ArchitectureMinimum One Version
Linuxx86_64V2.2.2
LinuxARM64V2.2.2
Windowsx86_64V2.2.2